ホーム › NetworkManagement.WNet › PF_NPGetUniversalName

PF_NPGetUniversalName

コールバック

シグネチャ

DWORD PF_NPGetUniversalName(
    LPWSTR lpLocalPath,
    DWORD dwInfoLevel,
    void* lpBuffer,
    DWORD* lpnBufferSize
);

パラメーター

フィールド

型

説明

lpLocalPath

LPWSTR

ネットワークリソース上のオブジェクトのローカルパスへのポインターです。これはドライブベースのパスです。

dwInfoLevel

DWORD

呼び出し元が必要とする情報の詳細レベルです。次のいずれかの値を指定できます。

値	意味
UNIVERSAL_NAME_INFO_LEVEL	名前の UNC 形式を取得します。例: "file:\\server\share" この値が設定されている場合、lpBuffer に返されるデータは UNIVERSAL_NAME_INFO 構造体として格納されます。
REMOTE_NAME_INFO_LEVEL	名前のリモート形式を取得します。例: "\\server\share" この値が設定されている場合、lpBuffer に返されるデータは REMOTE_NAME_INFO 構造体として格納されます。

lpBuffer

void*

ユーザーが要求した情報を受け取るバッファーへのポインターです。返される具体的な構造体は、dwInfoLevel で指定した情報レベルによって異なります。

lpnBufferSize

DWORD*

公式ドキュメント

ネットワークリソースのユニバーサル名を取得します。NPGetUniversalName 関数は、このユニバーサル名を UNC 形式、または古い形式であるリモート名形式で取得できます。

戻り値

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

リターンコード	説明
WN_BAD_LOCALNAME	lpLocalPath に渡された値が無効です。
WN_NOT_CONNECTED	lpLocalPath に渡された値がリダイレクトされたデバイスではありません。
WN_MORE_DATA	バッファーが小さすぎます。
WN_NO_NETWORK	ネットワークが存在しません。

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