Compartir a través de

Función DsCrackUnquotedMangledRdnA (dsparse.h)

  • Artículo

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

Consulte también

DS_MANGLE_FOR

Funciones de administración de controlador de dominio y replicación

DsIsMangledDn

DsIsMangledRdnValue

DsUnquoteRdnValue