Función DsClientMakeSpnForTargetServerA (ntdsapi.h)

La función DsClientMakeSpnForTargetServer construye un nombre de entidad de seguridad de servicio (SPN) que identifica un servidor específico que se va a usar para la autenticación.

Sintaxis

NTDSAPI DWORD DsClientMakeSpnForTargetServerA(
  [in]      LPCSTR ServiceClass,
  [in]      LPCSTR ServiceName,
  [in, out] DWORD  *pcSpnLength,
  [out]     LPSTR  pszSpn
);

Parámetros

[in] ServiceClass

Puntero a una cadena terminada en null que contiene la clase del servicio tal y como se define en el servicio. Puede ser cualquier cadena única para el servicio.

[in] ServiceName

Puntero a una cadena terminada en null que contiene el nombre de host del servicio de nombres distintivos (DNS). Puede ser un nombre completo o una dirección IP en el formato estándar de Internet.

No se recomienda el uso de una dirección IP para ServiceName porque esto puede crear un problema de seguridad. Antes de construir el SPN, la dirección IP debe traducirse a un nombre de equipo mediante la resolución de nombres DNS. Es posible que la resolución de nombres DNS sea suplantada, reemplazando el nombre de equipo previsto por un nombre de equipo no autorizado.

[in, out] pcSpnLength

Puntero a un valor DWORD que, en la entrada, contiene el tamaño del búfer pszSpn , en caracteres. En la salida, este parámetro recibe el número de caracteres copiados en el búfer pszSpn , incluido el valor NULL de terminación.

[out] pszSpn

Puntero a un búfer de cadena que recibe el SPN.

Valor devuelto

Esta función devuelve códigos de error estándar de Windows.

Comentarios

Al usar esta función, proporcione la clase de servicio y parte de un nombre de host DNS.

Esta función es una versión simplificada de la función DsMakeSpn . ServiceName se convierte en canónico resolviendo a través de DNS.

No se admiten nombres DNS basados en GUID. Cuando se construye, el SPN simplificado es el siguiente:

ServiceClass / ServiceName / ServiceName

La parte del nombre de instancia (segunda posición) siempre se establece en el valor predeterminado. No se usan los campos de puerto y de referencia.

Nota

El encabezado ntdsapi.h define DsClientMakeSpnForTargetServer 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 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	ntdsapi.h
Library	Ntdsapi.lib
Archivo DLL	Ntdsapi.dll

Consulte también

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

DsMakeSpn