Función DsCrackUnquotedMangledRdnA (dsparse.h)

Artículo
02/29/2024

La función DsCrackUnquotedMangledRdn unmangles (uncodes) un nombre distintivo relativo determinado y devuelve el GUID descodificado y el tipo de mangling usado.

Sintaxis

DSPARSE BOOL DsCrackUnquotedMangledRdnA(
  [in]            LPCSTR        pszRDN,
  [in]            DWORD         cchRDN,
  [out, optional] GUID          *pGuid,
  [out, optional] DS_MANGLE_FOR *peDsMangleFor
);

Parámetros

[in] pszRDN

Puntero a una cadena que contiene el nombre distintivo relativo (RDN) que se va a traducir. El parámetro cchRDN especifica esta longitud de cadena, por lo que esta cadena no es necesaria para terminar en null. Esta cadena debe tener un formato sin comilla. Para obtener más información sobre los nombres distintivos relativos sin comillas, vea DsUnquoteRdnValue.

[in] cchRDN

Contiene la longitud, en caracteres, de la cadena pszRDN .

[out, optional] pGuid

Puntero al valor GUID que recibe el GUID del nombre distintivo relativo no administrado. Este parámetro puede ser NULL.

[out, optional] peDsMangleFor

Puntero a un valor de DS_MANGLE_FOR que recibe el tipo de mangling usado en el nombre distintivo relativo mangled. Este parámetro puede ser NULL.

Valor devuelto

Esta función devuelve TRUE si el nombre distintivo relativo es mangled o FALSE en caso contrario. Si esta función devuelve FALSE, ni pGuid ni peDsMangleFor reciben ningún dato.

Comentarios

Esta función intenta descodificar (unmangle) una RDN que se ha administrado previamente debido a una eliminación o a un conflicto de nomenclatura. Si se administra el nombre distintivo relativo, la función devuelve TRUE y recupera el guid y el tipo de mangle, si se solicita. Si el nombre distintivo relativo no se administra, la función devuelve FALSE.

Nota

El encabezado dsparse.h define DsCrackUnquotedMangledRdn como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	dsparse.h (incluya Ntdsapi.h)
Library	Ntdsapi.lib
Archivo DLL	Ntdsapi.dll