ホーム › NetworkManagement.WNet › PF_NPGetConnection

PF_NPGetConnection

コールバック

シグネチャ

DWORD PF_NPGetConnection(
    LPWSTR lpLocalName,
    LPWSTR lpRemoteName,
    DWORD* lpnBufferLen
);

パラメーター

フィールド	型	説明
lpLocalName	LPWSTR	呼び出し元が対象とするローカルデバイスの名前へのポインターです。ネットワークプロバイダーは、この名前が構文的に有効であると想定できます。
lpRemoteName	LPWSTR	接続の確立に使用されたリモート名を受け取るバッファーへのポインターです。このバッファーは呼び出し元が割り当てます。
lpnBufferLen	DWORD*	lpRemoteName バッファーのサイズ (文字数) へのポインターです。バッファーが十分な大きさでないために呼び出しが失敗した場合、lpBufferSize には必要なバッファーサイズが設定されます。

公式ドキュメント

接続に関する情報を取得します。

戻り値

関数が成功した場合は WN_SUCCESS を返します。それ以外の場合はエラーコードを返します。エラーコードは次のいずれかです。

戻り値	説明
WN_NOT_CONNECTED	lpLocalName で指定されたデバイスは、このプロバイダーによってリダイレクトされていません。
WN_MORE_DATA	バッファーが小さすぎたため、すべてのデータを受け取ることができませんでした。
WN_NO_NETWORK	ネットワークが存在しません。

解説(Remarks)

NPGetConnection 関数は、現在接続されているネットワーク接続に関する情報のみを返すことができます。現在切断されているネットワーク接続に関する情報を取得するには、 NPGetConnection3 を使用してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)