次の方法で共有


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 を含む)

こちらもご覧ください

アクセス制御の概要

基本的なAccess Control関数

EqualPrefixSid

LookupAccountName

SID

SID_NAME_USE