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相同，只不过最右边的正斜杠 (/) 替换为换行符 (\n) ，即使在仅域的情况下， (example.microsoft.com/software\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

指向 UNICODE_STRING 结构的指针，该结构接收拥有 NameInput 参数指定名称的域的名称。

[out] SubStatus

指向变量的指针，该变量接收有关函数调用的返回值的其他信息。

返回值

如果函数成功，该函数将返回STATUS_SUCCESS。

如果该函数失败，它将返回STATUS_UNSUCCESSFUL。 有关详细信息，请参阅 SubStatus 参数中返回的值。

注解

SpInitialize 函数接收的 LSA_SECPKG_FUNCTION_TABLE 结构中提供了指向 CrackSingleName 函数的指针。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 ntsecpkg.h

另请参阅

LSA_SECPKG_FUNCTION_TABLE

SpInitialize