擷取目前預設使用者名稱的值,或用來建立網路連線的用戶名稱。
語法
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 |
|---|---|
|
lpName 參數中的值不是重新導向裝置的名稱或已連接的遠端名稱。 |
|
緩衝區 lpUserName 太小。 |
|
網路不存在。 |
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| Header | npapi.h |
| Library | davclnt.lib |