ホーム › Security.Authentication.Identity › PLSA_CRACK_SINGLE_NAME

PLSA_CRACK_SINGLE_NAME

コールバック

シグネチャ

NTSTATUS PLSA_CRACK_SINGLE_NAME(
    DWORD FormatOffered,
    BOOLEAN PerformAtGC,
    LSA_UNICODE_STRING* NameInput,
    LSA_UNICODE_STRING* Prefix,
    DWORD RequestedFormat,
    LSA_UNICODE_STRING* CrackedName,
    LSA_UNICODE_STRING* DnsDomainName,
    DWORD* SubStatus
);

パラメーター

フィールド

型

説明

FormatOffered

DWORD

入力される名前の形式。このパラメーターに指定できる値を次の表に示します。

値	意味
DS_CANONICAL_NAME	完全な正規名 (例: example.microsoft.com/software/someone)。ドメインのみの形式では、末尾にスラッシュ (/) が付きます。
DS_CANONICAL_NAME_EX	DS_CANONICAL_NAME と同じですが、最も右側のスラッシュ (/) が改行文字 (\n) に置き換えられます。これはドメインのみの場合でも同様です (例: example.microsoft.com/software\nsomeone)。
DS_DISPLAY_NAME	分かりやすい表示名。表示名は、必ずしも定義に用いられる相対識別名 (RDN) であるとは限りません。
DS_FQDN_1779_NAME	完全修飾識別名 (例: CN=NameOfPerson,OU=Users,DC=Example,DC=Fabrikam,DC=Com)。
DS_NT4_ACCOUNT_NAME	Windows のアカウント名 (例: Example\Name)。ドメインのみの形式では、末尾に円記号 (\\) が付きます。
DS_SERVICE_PRINCIPAL_NAME	一般化されたサービスプリンシパル名 (例: www/www.microsoft.com@microsoft.com)。
DS_SID_OR_SID_HISTORY_NAME	オブジェクトのセキュリティ識別子 (SID)。現在の SID と、オブジェクトの SID 履歴に含まれる SID のどちらでも指定できます。SID 文字列には、SID の標準的な文字列表現、または Sddl.h で定義されている文字列定数のいずれかを使用できます。バイナリ形式の SID を SID 文字列に変換する方法については、SID Strings を参照してください。この値は formatDesired パラメーターには指定できません。
DS_UNIQUE_ID_NAME	IIDFromString 関数が返す GUID 文字列 (例: {4fa050f0-f561-11cf-bdd9-00aa003a77b6})。
DS_UNKNOWN_NAME	不明な名前の種類です。
DS_USER_PRINCIPAL_NAME	ユーザープリンシパル名 (例: someone@example.microsoft.com)。

PerformAtGC

BOOLEAN

グローバルカタログサーバーで変換を実行するかどうかを指定します。

NameInput

LSA_UNICODE_STRING*

変換する名前を格納した UNICODE_STRING 構造体へのポインター。

Prefix

LSA_UNICODE_STRING*

名前に付けるプレフィックスを指定する UNICODE_STRING 構造体へのポインター。

RequestedFormat

DWORD

変換後の名前に要求する形式。指定できる値の一覧については、FormatOffered パラメーターを参照してください。

CrackedName

LSA_UNICODE_STRING*

変換された名前を受け取る UNICODE_STRING 構造体へのポインター。

DnsDomainName

LSA_UNICODE_STRING*

NameInput パラメーターで指定された名前を所有するドメインの名前を受け取る UNICODE_STRING 構造体へのポインター。

SubStatus

DWORD*

関数呼び出しの戻り値に関する追加情報を受け取る変数へのポインター。

公式ドキュメント

CrackSingleName 関数は、名前をある形式から別の形式に変換します。

戻り値

関数が成功した場合は、STATUS_SUCCESS を返します。

関数が失敗した場合は、STATUS_UNSUCCESSFUL を返します。詳細については、SubStatus パラメーターに返される値を参照してください。

解説(Remarks)

CrackSingleName 関数へのポインターは、 LSA_SECPKG_FUNCTION_TABLE 構造体に含まれています。この構造体は SpInitialize 関数が受け取ります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)