LookupAccountSidLocalA 函式（winbase.h）

發行項
11/20/2024

LookupAccountSidLocalA 定義為巨集，該巨集會呼叫 LookupAccountSidA 做為第一個參數 NULL。擷取本機計算機上指定 SID 的帳戶名稱。

語法

BOOL LookupAccountSidLocalA(
  [in]            PSID          Sid,
  [out, optional] LPSTR         Name,
  [in, out]       LPDWORD       cchName,
  [out, optional] LPSTR         ReferencedDomainName,
  [in, out]       LPDWORD       cchReferencedDomainName,
  [out]           PSID_NAME_USE peUse
);

參數

[in] Sid

要查閱之 SID 的指標。

[out, optional] Name

緩衝區的指標，接收 null-terminated 字串，其中包含對應至 lpSid 參數的帳戶名稱。

[in, out] cchName

在輸入上，指定 lpName 緩衝區 TCHAR秒的大小。如果函式因為緩衝區太小或 cchName 為零而失敗，cchName 會收到所需的緩衝區大小，包括終止 null 字元。

[out, optional] ReferencedDomainName

緩衝區的指標，接收 null-terminated 字串，其中包含找到帳戶名稱的功能變數名稱。

在伺服器上，本機計算機安全性資料庫中大部分帳戶所傳回的功能變數名稱是伺服器是域控制器的功能變數名稱。

在工作站上，本機計算機安全性資料庫中大部分帳戶所傳回的功能變數名稱是系統最後一次啟動時計算機的名稱（排除反斜杠）。如果計算機名稱變更，舊名稱會繼續以功能變數名稱的形式傳回，直到系統重新啟動為止。

某些帳戶是由系統預先定義的。針對這些帳戶傳回的功能變數名稱是 BUILTIN。

[in, out] cchReferencedDomainName

在輸入上，指定 lpReferencedDomainName 緩衝區 TCHARs 的大小。如果函式因為緩衝區太小或 cchReferencedDomainName 為零而失敗，cchReferencedDomainName 會收到所需的緩衝區大小，包括結束 null 字元。

[out] peUse

接收 SID_NAME_USE 值之變數的指標，表示帳戶的類型。

傳回值

如果函式成功，函式會傳回非零。

如果函式失敗，則會傳回零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

言論

此函式類似於 LookupAccountSid，但會將搜尋限制為本機電腦。

注意

winbase.h 標頭會根據 UNICODE 預處理器常數的定義，將 LookupAccountSidLocal 定義為自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求

要求	價值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
支援的最低伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平臺	窗戶
標頭	winbase.h （包括 Windows.h）