GetDllDirectoryA 関数 (winbase.h)
アプリケーションの DLL の検索に使用される検索パスのアプリケーション固有の部分を取得します。
構文
DWORD GetDllDirectoryA(
[in] DWORD nBufferLength,
[out] LPSTR lpBuffer
);
パラメーター
[in] nBufferLength
出力バッファーのサイズ (文字単位)。
[out] lpBuffer
検索パスのアプリケーション固有の部分を受け取るバッファーへのポインター。
戻り値
関数が成功した場合、戻り値は lpBuffer にコピーされた文字列の長さ (文字単位) であり、終端の null 文字は含まれません。 戻り値が nBufferLength より大きい場合は、パスに必要なバッファーのサイズを指定します。
関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。
解説
この関数を使用するアプリケーションをコンパイルするには、 _WIN32_WINNTを 0x0502 以降として定義します。 詳細については、「 Windows ヘッダーの使用」を参照してください。
注意
winbase.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GetDllDirectory を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista、WINDOWS XP と SP1 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | winbase.h (Windows.h を含む) |
Library | Kernel32.lib |
[DLL] | Kernel32.dll |