NPGetUniversalName 関数 (npapi.h)

  • [アーティクル]

ネットワーク リソースの汎用名を取得します。 NPGetUniversalName 関数は、UNC 形式または古いリモート名形式で、この汎用名を取得できます。

構文

DWORD NPGetUniversalName(
  [in]      LPCWSTR lpLocalPath,
  [in]      DWORD   dwInfoLevel,
  [out]     LPVOID  lpBuffer,
  [in, out] LPDWORD lpBufferSize
);

パラメーター

[in] lpLocalPath

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

[in] dwInfoLevel

呼び出し元が関心を持つ情報の詳細レベル。 これには、次のいずれかの値を指定できます。

値 意味
UNIVERSAL_NAME_INFO_LEVEL
 名前の UNC 形式を取得します (例: "file:\\server\share"

この値が設定されている場合、 lpBuffer で返されるデータは 、UNIVERSAL_NAME_INFO 構造体として格納されます。
REMOTE_NAME_INFO_LEVEL
 名前のリモート 形式 ("\\server\share" など) を取得します。

この値が設定されている場合、 lpBuffer で返されるデータは 、REMOTE_NAME_INFO 構造体として格納されます。

[out] lpBuffer

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

[in, out] lpBufferSize

lpBuffer バッファーのサイズ (バイト単位) へのポインター。 バッファーが十分な大きさでないために呼び出しが失敗した場合、この場所を使用して必要なバッファー サイズが返されます。

戻り値

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

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

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー npapi.h