次の方法で共有


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

こちらもご覧ください

WNetGetNetworkInformation

WNetGetResourceInformation

WNetGetUniversalName

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

Windows ネットワーク関数