LookupAccountSidLocalA 関数 (winbase.h)
LookupAccountSidLocalA は、最初のパラメーターとして を使用して LookupAccountSidANULL を呼び出すマクロとして定義されます。 ローカル コンピューター上の指定された 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
lpSid パラメーターに対応するアカウント名を含む null で終わる文字列を受け取るバッファーへのポインター。
[in, out] cchName
入力時に、lpName バッファーのサイズを TCHARs で指定します。 バッファーが小さすぎるために関数が失敗した場合、または cchName が 0 の場合、 cchName は必要なバッファー サイズ (終端 の null 文字を含む) を受け取ります。
[out, optional] ReferencedDomainName
アカウント名が見つかったドメインの名前を含む null で終わる文字列を受け取るバッファーへのポインター。
サーバーでは、ローカル コンピューターのセキュリティ データベース内のほとんどのアカウントに対して返されるドメイン名は、サーバーがドメイン コントローラーであるドメインの名前です。
ワークステーションでは、ローカル コンピューターのセキュリティ データベース内のほとんどのアカウントに対して返されるドメイン名は、システムの最後の起動時のコンピューターの名前です (円記号は除外されます)。 コンピューターの名前が変更された場合、システムが再起動されるまで、古い名前はドメイン名として引き続き返されます。
一部のアカウントは、システムによって事前に定義されています。 これらのアカウントに返されるドメイン名は BUILTIN です。
[in, out] cchReferencedDomainName
入力時に、lpReferencedDomainName バッファーのサイズを TCHARs で指定します。 バッファーが小さすぎるために関数が失敗した場合、または cchReferencedDomainName が 0 の場合、 cchReferencedDomainName は必要なバッファー サイズ (終端 の null 文字を含む) を受け取ります。
[out] peUse
アカウントの種類を示す SID_NAME_USE 値を受け取る変数へのポインター。
戻り値
関数が成功した場合、関数は 0 以外の値を返します。
関数が失敗すると、0 が返されます。 詳細なエラー情報を得るには、GetLastError を呼び出します。
解説
この関数は LookupAccountSid に似ていますが、検索をローカル コンピューターに制限します。
注意
winbase.h ヘッダーは、LookupAccountSidLocal をエイリアスとして定義します。これは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | winbase.h (Windows.h を含む) |