Compartilhar via

Função DnsServiceConstructInstance (windns.h)

  • Artigo

Usado para criar uma estrutura DNS_SERVICE_INSTANCE com base em dados que a descrevem.

Sintaxe

PDNS_SERVICE_INSTANCE DnsServiceConstructInstance(
  PCWSTR       pServiceName,
  PCWSTR       pHostName,
  PIP4_ADDRESS pIp4,
  PIP6_ADDRESS pIp6,
  WORD         wPort,
  WORD         wPriority,
  WORD         wWeight,
  DWORD        dwPropertiesCount,
  PCWSTR       *keys,
  PCWSTR       *values
);

Parâmetros

pServiceName

Uma cadeia de caracteres que representa o nome do serviço.

pHostName

Uma cadeia de caracteres que representa o nome do host do serviço.

pIp4

Um ponteiro para uma estrutura IP4_ADDRESS que representa o endereço IPv4 associado ao serviço.

pIp6

Um ponteiro para uma estrutura IP6_ADDRESS que representa o endereço IPv6 associado ao serviço.

wPort

Um valor que representa a porta na qual o serviço está em execução.

wPriority

Um valor que representa a prioridade do serviço.

wWeight

Um valor que representa o peso do serviço.

dwPropertiesCount

O número de propriedades define o número de elementos nas matrizes dos keys parâmetros e values .

keys

Um ponteiro para uma matriz de valores de cadeia de caracteres que representam as chaves de propriedade.

values

Um ponteiro para uma matriz de valores de cadeia de caracteres que representam os valores de propriedade correspondentes.

Retornar valor

Um ponteiro para uma estrutura de DNS_SERVICE_INSTANCE recém-alocada, criada a partir dos parâmetros passados. Seu aplicativo é responsável por liberar a memória associada chamando DnsServiceFreeInstance.

Comentários

O campo dwInterfaceIndex da estrutura retornada é definido como 0.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho windns.h
Biblioteca dnsapi.lib
DLL dnsapi.dll