<Return[A]><Top>

AVIFileOpen

Declare Function Api_AVIFileOpen& Lib "avifil32" Alias "AVIFileOpenA" (ppFile&, ByVal szFile$, ByVal Mode&, pclsidHandler As Any)

Declare Function AVIFileOpen Lib "avifil32" Alias "AVIFileOpenA" (ppfile As Long, ByVal szFile As String, ByVal mode As Long, pclsidHandler As Any) As Long

AVI ファイルを開き、それにアクセスするのに使うファイルインターフェイスのアドレスをを取得する。AVIFile ライブラリは、ファイルが開かれた回数のカウントを管理するが、解放された回数のカウントは管理しない。ファイルを解放してカウントを 1 つ減らすには、AVIFileRelease 関数を使う。

パラメータ
ppfile
    新しいファイルインターフェイスポインタが受け取るアドレスを指定する。
szFile
    開くファイルのファイル名が入った、NULL で終わる文字列を指定する。
mode
    ファイルを開くときに使うアクセスモードを指定する。デフォルトのアクセスモードは OF_READ である。

    AVIFileOpen 関数では、次のアクセスモードを指定することができる。

    値                                       

説明                                                                                                           

    OF_CREATE

新しいファイルを作成する。ファイルがすでに存在する場合、その長さが 0 になる。

    OF_SHARE_DENY_NONE

ファイルを非排他的に開く。他のプロセスは、このファイルを読み取り専用または書き込み専用で開くことが

　

できる。他のプロセスがこのファイルを互換モードで開いている場合は、AVIFileOpen 関数は失敗する。

    OF_SHARE_DENY_READ

ファイルを非排他的に開く。他のプロセスは、このファイルを書き込み専用で開くことができる。

　

他のプロセスがこのファイルを互換モードまたは読み取り専用で開いている場合は、AVIFileOpen 関数は失

　

敗する。

    OF_SHARE_DENY_WRITE

ファイルを非排他的に開く。他のプロセスは、そのファイルを読み取り専用で開くことができる。

　

他のプロセスがこのファイルを互換モードまたは書き込み専用で開いている場合は、AVIFileOpen 関数は失

　

敗する。

    OF_SHARE_EXCLUSIVE

ファイルを開き、そのファイルに対する他のプロセスからのアクセスを禁止する。

　

他のプロセスがこのファイルを開いている場合は、AVIFileOpen 関数は失敗する。

    OF_READ

ファイルを読み取り用に開く。

    OF_READWRITE

ファイルを読み取りおよび書き込み用に開く。

    OF_WRITE

ファイルを書き込み用に開く。

pclsidHandler
    使いたい標準ハンドラまたはカスタムハンドラのクラス識別子のアドレスを指定する。この値に NULL を指定すると、 システムは、ファイル

    で指定されているファイル拡張子や RIFF タイプに基づいて、レジストリからハンドラを 1 つ選ぶ。


戻り値

    関数が成功すると 0 が返る。

    関数が失敗するとエラーが返る。

    返されるエラー値

    値                                       

説明                                                                                                       

    AVIERR_BADFORMAT

ファイルが破損しているか、フォーマットが不明のため、読み取りができない。

    AVIERR_MEMORY

メモリ不足のため、ファイルを開けられない。

    AVIERR_FILEREAD

ファイルの読み取り中にディスク エラーが発生した。

    AVIERR_FILEOPEN

ファイルのオープン中にディスク エラーが発生した。

    REGDB_E_CLASSNOTREG

AVIFileOpen 関数で指定されたファイルタイプを持つハンドラが、レジストリに見つ からなかった。