Compartilhar via

Função DnsServiceRegister (windns.h)

  • Artigo

Usado para registrar um serviço detectável neste dispositivo.

Sintaxe

DWORD DnsServiceRegister(
  PDNS_SERVICE_REGISTER_REQUEST pRequest,
  PDNS_SERVICE_CANCEL           pCancel
);

Parâmetros

pRequest

Um ponteiro para uma estrutura DNS_SERVICE_REGISTER_REQUEST que contém informações sobre o serviço a ser registrado.

pCancel

Um ponteiro opcional (pode ser nullptr) para uma estrutura DNS_SERVICE_CANCEL que pode ser usada para cancelar uma operação de registro assíncrona pendente. Se não nullptrfor , esse identificador deverá permanecer válido até que o registro seja cancelado.

Retornar valor

Se tiver êxito, retornará DNS_REQUEST_PENDING; caso contrário, retorna o código de erro específico do DNS apropriado, conforme definido em Winerror.h. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Essa função é assíncrona. O retorno de chamada de registro será chamado assim que o registro for bem-sucedido. Para cancelar o registro do serviço, chame DnsServiceDeRegister.   O registro está vinculado ao tempo de vida do processo de chamada. Se o processo desaparecer, o serviço será automaticamente desregistrado.

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