Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Expand Minimize

CrackSingleName function

The CrackSingleName function converts a name from one format to another.

Syntax


NTSTATUS CrackSingleName(
  _In_     ULONG           FormatOffered,
  _In_     BOOLEAN         PerformAtGC,
  _In_     PUNICODE_STRING NameInput,
  _In_opt_ PUNICODE_STRING Prefix,
  _In_     ULONG           RequestedFormat,
  _Out_    PUNICODE_STRING CrackedName,
  _Out_    PUNICODE_STRING DnsDomainName,
  _Out_    PULONG          SubStatus
);

Parameters

FormatOffered [in]

The format of the input name. The following table contains the valid values for this parameter.

ValueMeaning
DS_CANONICAL_NAME

Complete canonical name (for example, example.microsoft.com/software/someone). The domain-only version includes a trailing forward slash (/).

DS_CANONICAL_NAME_EX

Same as DS_CANONICAL_NAME except that the rightmost forward slash (/) is replaced with a newline character (\n), even in a domain-only case (for example, example.microsoft.com/software\nsomeone).

DS_DISPLAY_NAME

A "friendly" display name. The display name is not necessarily the defining relative distinguished name (RDN).

DS_FQDN_1779_NAME

Fully qualified distinguished name (for example, CN=NameOfPerson,OU=Users,DC=Example,DC=Fabrikam,DC=Com).

DS_NT4_ACCOUNT_NAME

Windows account name (for example, Example\Name). The domain-only version includes trailing backslashes (\\).

DS_SERVICE_PRINCIPAL_NAME

Generalized service principal name (for example, www/www.microsoft.com@microsoft.com).

DS_SID_OR_SID_HISTORY_NAME

A security identifier (SID) for the object. This can be either the current SID or a SID from the object's SID history. The SID string can use either the standard string representation of a SID, or one of the string constants defined in Sddl.h. For information about converting a binary SID into a SID string, see SID Strings. This value is not valid for the formatDesired parameter.

DS_UNIQUE_ID_NAME

GUID string that the IIDFromString function returns (for example, {4fa050f0-f561-11cf-bdd9-00aa003a77b6}).

DS_UNKNOWN_NAME

Unknown name type.

DS_USER_PRINCIPAL_NAME

User principal name (for example, someone@example.microsoft.com).

 

PerformAtGC [in]

Specifies whether to perform the translation at a global catalog server.

NameInput [in]

A pointer to a UNICODE_STRING structure that contains the name to convert.

Prefix [in, optional]

A pointer to a UNICODE_STRING structure that specifies a prefix for the name.

RequestedFormat [in]

The requested format of the cracked name. For a list of valid values, see the FormatOffered parameter.

CrackedName [out]

A pointer to a UNICODE_STRING structure that receives the reformatted name.

DnsDomainName [out]

A pointer to a UNICODE_STRING structure that receives the name of the domain that owns the name specified by the NameInput parameter.

SubStatus [out]

A pointer to a variable that receives additional information about the return value of the function call.

Return value

If the function succeeds, the function returns STATUS_SUCCESS.

If the function fails, it returns STATUS_UNSUCCESSFUL. For more information, see the value returned in the SubStatus parameter.

Remarks

A pointer to the CrackSingleName function is available in the LSA_SECPKG_FUNCTION_TABLE structure received by the SpInitialize function.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Ntsecpkg.h

See also

LSA_SECPKG_FUNCTION_TABLE
SpInitialize

 

 

Community Additions

ADD
Show:
© 2015 Microsoft