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 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winnetwk.h |
| Library | Mpr.lib |
| [DLL] | Mpr.dll |