LookupAccountSidLocalW 関数 (winbase.h)

[アーティクル]
03/08/2023

LookupAccountSidLocalW は、最初のパラメーターとしてを使用して LookupAccountSidWNULL を呼び出すマクロとして定義されます。ローカルコンピューター上の指定された SID のアカウントの名前を取得します。

構文

BOOL LookupAccountSidLocalW(
  [in]            PSID          Sid,
  [out, optional] LPWSTR        Name,
  [in, out]       LPDWORD       cchName,
  [out, optional] LPWSTR        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 を含む)