LSA_CRACK_SINGLE_NAME コールバック関数 (ntsecpkg.h)

  • [アーティクル]

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

構文

LSA_CRACK_SINGLE_NAME LsaCrackSingleName;

NTSTATUS LsaCrackSingleName(
  [in]           ULONG FormatOffered,
  [in]           BOOLEAN PerformAtGC,
  [in]           PUNICODE_STRING NameInput,
  [in, optional] PUNICODE_STRING Prefix,
  [in]           ULONG RequestedFormat,
  [out]          PUNICODE_STRING CrackedName,
  [out]          PUNICODE_STRING DnsDomainName,
  [out]          PULONG SubStatus
)
{...}

パラメーター

[in] FormatOffered

入力名の形式。 次の表に、このパラメーターの有効な値を示します。

値 意味
DS_CANONICAL_NAME
 正規名 (たとえば、example.microsoft.com/software/someone) を入力します。 ドメインのみのバージョンには、末尾のスラッシュ (/) が含まれています。
DS_CANONICAL_NAME_EX
 DS_CANONICAL_NAMEと同じですが、右端のスラッシュ (/) は、ドメインのみの場合 (たとえば、他のユーザー example.microsoft.com/software\n) であっても、改行文字 (\n) に置き換えられます。
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 文字列」を参照してください。 この値は、 formatDesired パラメーターでは無効です。
DS_UNIQUE_ID_NAME
 IIDFromString 関数が返す GUID 文字列 (たとえば、{4fa050f0-f561-11cf-bdd9-00aa003a77b6})。
DS_UNKNOWN_NAME
 名前の種類が不明です。
DS_USER_PRINCIPAL_NAME
 ユーザー プリンシパル名 (例: someone@example.microsoft.com)。

[in] PerformAtGC

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

[in] NameInput

変換する名前を含む UNICODE_STRING 構造体へのポインター。

[in, optional] Prefix

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

[in] RequestedFormat

割れた名前の要求された形式。 有効な値の一覧については、 FormatOffered パラメーターを参照してください。

[out] CrackedName

再フォーマットされた名前を受け取る UNICODE_STRING 構造体へのポインター。

[out] DnsDomainName

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

[out] SubStatus

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

戻り値

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

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

注釈

CrackSingleName 関数へのポインターは、SpInitialize 関数によって受信されたLSA_SECPKG_FUNCTION_TABLE構造体で使用できます。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー ntsecpkg.h

こちらもご覧ください

LSA_SECPKG_FUNCTION_TABLE

SpInitialize