WNetGetProviderNameA 関数 (winnetwk.h)
WNetGetProviderName 関数は、特定の種類のネットワークのプロバイダー名を取得します。
構文
DWORD WNetGetProviderNameA(
[in] DWORD dwNetType,
[out] LPSTR lpProviderName,
[in, out] LPDWORD lpBufferSize
);
パラメーター
[in] dwNetType
ネットワークに固有のネットワークの種類。 2 つのネットワークが同じ型を要求する場合、関数は最初に読み込まれたプロバイダーの名前を返します。 ネットワークの種類の上位ワードのみが使用されます。 ネットワークが下位ワードのサブタイプを報告する場合は無視されます。
ネットワークの種類の完全な一覧は、ヘッダー ファイル Winnetwk.h にあります。
[out] lpProviderName
ネットワーク プロバイダー名を受け取るバッファーへのポインター。
[in, out] lpBufferSize
関数に渡されるバッファーのサイズ (文字単位)。 戻り値がERROR_MORE_DATAの場合、lpBufferSize
Windows Me/98/95: バッファーのサイズは、文字ではなくバイト単位です。 また、バッファーの長さは 1 バイト以上にする必要があります。
戻り値
関数が成功した場合、戻り値はNO_ERROR。
関数が失敗した場合、戻り値は システム エラー コード(次のいずれかの値など) です。
リターン コード | 形容 |
---|---|
|
バッファーが小さすぎてネットワーク プロバイダー名を保持できません。 |
|
ネットワークは使用できません。 |
|
lpProviderName パラメーターまたは lpBufferSize パラメーターが無効です。 |
備考
手記
winnetwk.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして WNetGetProviderName を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | winnetwk.h |
ライブラリ | Mpr.lib |
DLL | Mpr.dll |
関連項目
WNetGetNetworkInformation の
WNetGetResourceInformation の