Compartir a través de

Función DsUnquoteRdnValueA (dsparse.h)

  • Artículo

La función DsUnquoteRdnValue es una llamada de cliente que convierte un valor RDN entre comillas en un valor RDN sin comillas. Dado que el RDN se puso originalmente entre comillas porque contenía caracteres que se podían interpretar mal cuando se incrustaba dentro de un nombre distintivo (DN), el valor RDN sin comillas no debe enviarse como parte de un DN al servicio de directorio mediante varias API como LDAP.

Sintaxis

DSPARSE DWORD DsUnquoteRdnValueA(
  [in]      DWORD cQuotedRdnValueLength,
  [in]      LPCCH psQuotedRdnValue,
  [in, out] DWORD *pcUnquotedRdnValueLength,
  [out]     LPCH  psUnquotedRdnValue
);

Parámetros

[in] cQuotedRdnValueLength

Número de caracteres de la cadena psQuotedRdnValue.

[in] psQuotedRdnValue

Valor RDN que se puede entrecomillar y escapar.

[in, out] pcUnquotedRdnValueLength

El valor de entrada de este argumento es la longitud máxima, en caracteres, de psQuotedRdnValue.

El valor de salida de este argumento incluye las marcas siguientes.

ERROR_SUCCESS

Se devuelve si el número de caracteres coincide con la cadena usada en psQuotedRdnValue.

ERROR_BUFFER_OVERFLOW

Se devuelve si el número de caracteres no coincide con la cadena usada en psQuotedRdnValue.

[out] psUnquotedRdnValue

Valor RDN convertido y sin comprimido.

Valor devuelto

La lista siguiente contiene los valores posibles que se devuelven para la función DsUnquoteRdnValue.

Observaciones

Cuando psQuotedRdnValue se cita:

  • Se quitan las comillas iniciales y finales.
  • Espacio en blanco antes de descartar la primera cita.
  • Se descarta el espacio en blanco final de la última cita.
  • Los escapes se quitan y se mantiene el carácter que sigue al escape.
Las siguientes acciones se realizan cuando psQuotedRdnValue no está comprimido:
  • Se descarta el espacio en blanco inicial.
  • Se mantiene el espacio en blanco final.
  • Los caracteres que no son especiales de escape devuelven un error.
  • Los caracteres especiales sin escape devuelven un error.
  • Los valores de RDN que comienzan por # (omiiendo el espacio en blanco inicial) se controlan como un valor BER que se ha convertido previamente en una cadena y se convierten en consecuencia.
  • Los dígitos hexadecimales de escape (\89) se convierten en un byte binario (0x89).
  • Los escapes se quitan de los caracteres especiales con escape.
Las siguientes acciones siempre se realizan:
  • Los caracteres especiales con escape están sin escape.
  • Los valores RDN de entrada y salida no son valores terminados por null.

Nota

El encabezado dsparse.h define DsUnquoteRdnValue 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows Vista
servidor mínimo admitido Windows Server 2008
de la plataforma de destino de Windows
encabezado de dsparse.h (incluya Ntdsapi.h)
biblioteca de Ntdsapi.lib
DLL de Ntdsapi.dll

Consulte también

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

DsQuoteRdnValue