NPGetUser 函式 (npapi.h)

  • 發行項

擷取目前預設使用者名稱的值，或用來建立網路連線的用戶名稱。

語法

DWORD NPGetUser(
  [in]      LPWSTR  lpName,
  [out]     LPWSTR  lpUserName,
  [in, out] LPDWORD lpnBufferLen
);

參數

[in] lpName

呼叫端感興趣的本機裝置名稱指標，或使用者已建立連線之資源的遠端名稱。 如果呼叫端對目前登入系統的用戶名稱感興趣，這個參數可能是 NULL 或空字串。 如果傳入資源的遠端名稱，而且使用者會使用不同的名稱連接到該資源，則提供者可能無法解析要傳回的用戶名稱。 在此情況下，提供者可能會在可能的用戶名稱之間進行任意選擇。

[out] lpUserName

要接收用戶名稱之緩衝區的指標。 這應該是可以傳遞至 NPAddConnection 或 NPAddConnection3 函式的名稱，以使用相同的用戶名稱重新建立連線。

[in, out] lpnBufferLen

lpUserName 緩衝區的大小指標，以字元為單位。 如果呼叫失敗，因為緩衝區不夠大，這個位置將用來傳回所需的緩衝區大小。

傳回值

如果函式成功，它應該會傳回WN_SUCCESS。 否則，它應該會傳回錯誤碼，這可以是下列其中一項。

傳回碼 Description
WN_NOT_CONNECTED
 lpName 參數中的值不是重新導向裝置或連線遠端名稱的名稱。
WN_MORE_DATA
 緩衝區 lpUserName 太小。
WN_NO_NETWORK
 網路不存在。

規格需求

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