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