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。 否則，它應該會傳回錯誤碼，可能是下列其中一項。

傳回碼 Description
WN_BAD_LOCALNAME
 傳入 lpLocalPath 的值無效。
WN_NOT_CONNECTED
 傳入 lpLocalPath 的值不是重新導向的裝置。
WN_MORE_DATA
 緩衝區太小。
WN_NO_NETWORK
 網路不存在。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 npapi.h