estrutura SERVICE_INFOA (nspapi.h)

Artigo
03/13/2024

A estrutura SERVICE_INFO contém informações sobre um serviço de rede ou um tipo de serviço de rede.

Sintaxe

typedef struct _SERVICE_INFOA {
  LPGUID              lpServiceType;
  LPSTR               lpServiceName;
  LPSTR               lpComment;
  LPSTR               lpLocale;
  DWORD               dwDisplayHint;
  DWORD               dwVersion;
  DWORD               dwTime;
  LPSTR               lpMachineName;
  LPSERVICE_ADDRESSES lpServiceAddress;
  BLOB                ServiceSpecificInfo;
} SERVICE_INFOA, *PSERVICE_INFOA, *LPSERVICE_INFOA;

Membros

lpServiceType

Tipo: LPGUID

Um ponteiro para um GUID que é o tipo do serviço de rede.

lpServiceName

Tipo: LPTSTR

Um ponteiro para uma cadeia de caracteres terminada em NULL que é o nome do serviço de rede.

Se você estiver chamando a função SetService com o parâmetro dwNameSpace definido como NS_DEFAULT, o nome do serviço de rede deverá ser um nome comum. Um nome comum é o que o serviço de rede é comumente conhecido como. Um exemplo de um nome comum para um serviço de rede é "Meu SQL Server".

Se você estiver chamando a função SetService com o parâmetro dwNameSpace definido como um nome de serviço específico, o nome do serviço de rede poderá ser um nome comum ou um nome diferenciado. Um nome diferenciado distingue o serviço a um local exclusivo com um serviço de diretório. Um exemplo de um nome diferenciado para um serviço de rede é "MS\SYS\NT\DEV\My SQL Server".

lpComment

Tipo: LPTSTR

Um ponteiro para uma cadeia de caracteres terminada em NULL que é um comentário ou uma descrição para o serviço de rede. Por exemplo, "Usado para atualizações de desenvolvimento".

lpLocale

Tipo: LPTSTR

Um ponteiro para uma cadeia de caracteres terminada em NULL que contém informações de localidade.

dwDisplayHint

Tipo: DWORD

Uma dica de como exibir o serviço de rede em um adaptador de usuário de navegação de rede. Esse pode ser um dos valores a seguir.

Valor	Significado
RESOURCEDISPLAYTYPE_DOMAIN	Exiba o serviço de rede como um domínio.
RESOURCEDISPLAYTYPE_FILE	Exiba o serviço de rede como um arquivo.
RESOURCEDISPLAYTYPE_GENERIC	O método usado para exibir o objeto não importa.
RESOURCEDISPLAYTYPE_GROUP	Exiba o serviço de rede como um grupo.
RESOURCEDISPLAYTYPE_SERVER	Exiba o serviço de rede como um servidor.
RESOURCEDISPLAYTYPE_SHARE	Exiba o serviço de rede como um sharepoint.
RESOURCEDISPLAYTYPE_TREE	Exiba o serviço de rede como uma árvore.

dwVersion

Tipo: DWORD

A versão do serviço de rede. A palavra alta desse valor especifica um número de versão principal. A palavra baixa desse valor especifica um número de versão secundária.

dwTime

Tipo: DWORD

Reservado para uso futuro. Deve ser zero.

lpMachineName

Tipo: LPTSTR

Um ponteiro para uma cadeia de caracteres terminada em NULL que é o nome do computador no qual o serviço de rede está em execução.

lpServiceAddress

Tipo: LPSERVICE_ADDRESSES

Um ponteiro para uma estrutura SERVICE_ADDRESSES que contém uma matriz de estruturas SERVICE_ADDRESS . Cada estrutura SERVICE_ADDRESS contém informações sobre um endereço de serviço de rede.

Um serviço de rede pode chamar a função getsockname para determinar o endereço local do sistema.

ServiceSpecificInfo

Tipo: BLOB

Uma estrutura BLOB que especifica informações definidas pelo serviço.

Nota Em geral, os dados apontados pelo membro pBlobData da estrutura BLOB não devem conter ponteiros. Isso ocorre porque somente o serviço de rede sabe o formato dos dados; copiar os dados sem esse conhecimento levaria à invalidação do ponteiro. Se os dados apontados por pBlobData contiverem elementos de tamanho variável, os deslocamentos de pBlobData poderão ser usados para indicar o local desses elementos. Há uma exceção a essa regra geral: quando pBlobData aponta para uma estrutura SERVICE_TYPE_INFO_ABS . Isso é possível porque a estrutura SERVICE_TYPE_INFO_ABS e todas as estruturas SERVICE_TYPE_VALUE_ABS que ela contém são predefinidas e, portanto, seus formatos são conhecidos pelo sistema operacional.

Comentários

Observação

O cabeçalho nspapi.h define SERVICE_INFO como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	nspapi.h