次の方法で共有


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。

関数が失敗した場合、戻り値は システム エラー コード(次のいずれかの値など) です。

リターン コード 形容
ERROR_MORE_DATA
バッファーが小さすぎてネットワーク プロバイダー名を保持できません。
ERROR_NO_NETWORK
ネットワークは使用できません。
ERROR_INVALID_ADDRESS
lpProviderName パラメーターまたは lpBufferSize パラメーターが無効です。

備考

手記

winnetwk.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして WNetGetProviderName を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー winnetwk.h
ライブラリ Mpr.lib
DLL Mpr.dll

関連項目

WNetGetNetworkInformation の

WNetGetResourceInformation の

WNetGetUniversalName

Windows ネットワーク (WNet) の概要

Windows ネットワーク機能の