NPGetConnection3 関数 (npapi.h)
現在切断されている場合でも、ネットワーク接続に関する情報を取得します。
構文
DWORD NPGetConnection3(
[in] LPCWSTR lpLocalName,
[in] DWORD dwLevel,
[out] LPVOID lpBuffer,
[in, out] LPDWORD lpBufferSize
);
パラメーター
[in] lpLocalName
呼び出し元が関心のあるローカル デバイスの名前へのポインター。 プロバイダーは、これが構文的に有効であると想定できます。
[in] dwLevel
ネットワーク接続が現在接続されているか切断されているかを示す 値です。
値 | 意味 |
---|---|
|
ネットワーク接続が接続されています。 |
|
ネットワーク接続が切断されています。 |
[out] lpBuffer
要求された情報を含むバッファーを受け取る Void ポインター。
[in, out] lpBufferSize
lpBuffer バッファーのサイズ (文字単位) へのポインター。 バッファーが十分な大きさでないために呼び出しが失敗した場合、 lpBufferSize は必要なバッファー サイズに設定されます。
戻り値
関数が成功した場合は、WN_SUCCESSを返す必要があります。
関数が失敗した場合は、次のいずれかの値が返されます。
リターン コード | 説明 |
---|---|
|
lpLocalName で指定されたデバイスは、このプロバイダーによってリダイレクトされません。 |
|
バッファーが小さすぎて、すべてのデータを受信できませんでした。 |
|
ネットワークが存在しません。 |
注釈
ネットワーク接続は、接続済み、切断済み、使用不可の 3 つの状態で存在できます。 NPGetConnection3 関数は、現在使用できないネットワーク接続に関する情報を取得できません。 ただし、Windows には接続情報が格納されているため、現在切断されているネットワーク接続に関する情報を取得できます。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | npapi.h |