LSA_CRACK_SINGLE_NAME función de devolución de llamada (ntsecpkg.h)

  • Artículo

La función CrackSingleName convierte un nombre de un formato a otro.

Sintaxis

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
)
{...}

Parámetros

[in] FormatOffered

Formato del nombre de entrada. La tabla siguiente contiene los valores válidos para este parámetro.

Valor Significado
DS_CANONICAL_NAME
 Nombre canónico completo (por ejemplo, example.microsoft.com/software/someone). La versión de solo dominio incluye una barra diagonal final (/).
DS_CANONICAL_NAME_EX
 Igual que DS_CANONICAL_NAME excepto que la barra diagonal más a la derecha (/) se reemplaza por un carácter de nueva línea (\n), incluso en un caso de solo dominio (por ejemplo, example.microsoft.com/software\nalguien).
DS_DISPLAY_NAME
 Un nombre para mostrar "descriptivo". El nombre para mostrar no es necesariamente el nombre distintivo relativo definido (RDN).
DS_FQDN_1779_NAME
 Nombre distintivo completo (por ejemplo, CN=NameOfPerson,OU=Users,DC=Example,DC=Fabrikam,DC=Com).
DS_NT4_ACCOUNT_NAME
 Nombre de la cuenta de Windows (por ejemplo, Example\Name). La versión de solo dominio incluye barras diagonales inversas finales (\\).
DS_SERVICE_PRINCIPAL_NAME
 Nombre de entidad de seguridad de servicio generalizado (por ejemplo, www/www.microsoft.com@microsoft.com).
DS_SID_OR_SID_HISTORY_NAME
 Identificador de seguridad (SID) para el objeto. Puede ser el SID actual o un SID del historial de SID del objeto. La cadena SID puede usar la representación de cadena estándar de un SID o una de las constantes de cadena definidas en Sddl.h. Para obtener información sobre cómo convertir un SID binario en una cadena SID, vea Cadenas de SID. Este valor no es válido para el parámetro formatDesired .
DS_UNIQUE_ID_NAME
 Cadena GUID que devuelve la función IIDFromString (por ejemplo, {4fa050f0-f561-11cf-bdd9-00aaa03a77b6}).
DS_UNKNOWN_NAME
 Tipo de nombre desconocido.
DS_USER_PRINCIPAL_NAME
 Nombre principal de usuario (por ejemplo, someone@example.microsoft.com).

[in] PerformAtGC

Especifica si se debe realizar la traducción en un servidor de catálogo global.

[in] NameInput

Puntero a una estructura UNICODE_STRING que contiene el nombre que se va a convertir.

[in, optional] Prefix

Puntero a una estructura UNICODE_STRING que especifica un prefijo para el nombre.

[in] RequestedFormat

Formato solicitado del nombre descifrado. Para obtener una lista de valores válidos, consulte el parámetro FormatOffered .

[out] CrackedName

Puntero a una estructura UNICODE_STRING que recibe el nombre con formato.

[out] DnsDomainName

Puntero a una estructura UNICODE_STRING que recibe el nombre del dominio que posee el nombre especificado por el parámetro NameInput .

[out] SubStatus

Puntero a una variable que recibe información adicional sobre el valor devuelto de la llamada de función.

Valor devuelto

Si la función se realiza correctamente, la función devuelve STATUS_SUCCESS.

Si se produce un error en la función, devuelve STATUS_UNSUCCESSFUL. Para obtener más información, vea el valor devuelto en el parámetro SubStatus .

Comentarios

Hay disponible un puntero a la función CrackSingleName en la estructura LSA_SECPKG_FUNCTION_TABLE recibida por la función SpInitialize .

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ntsecpkg.h

Consulte también

LSA_SECPKG_FUNCTION_TABLE

SpInitialize