Função DnsServiceConstructInstance (windns.h)

Usado para criar uma estrutura de DNS_SERVICE_INSTANCE a partir de 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 parâmetros keys 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.

Valor de retorno

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.

Observações

O campo dwInterfaceIndex da estrutura retornada é definido como 0.

Requisitos