estrutura SERVICE_INFOA (nspapi.h)

Artigo
11/20/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:

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

lpServiceName

Tipo: LPTSTR

Um ponteiro para uma cadeia de caracteresNULL terminada 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 do serviço para 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 caracteresNULL terminada 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 um cadeia de caracteres nullterminada que contém informações de localidade.

dwDisplayHint

Tipo: DWORD

Uma dica de como exibir o serviço de rede em uma interface do 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 menor.

dwTime

Tipo: DWORD

Reservado para uso futuro. Deve ser zero.

lpMachineName

Tipo: LPTSTR

Um ponteiro para uma cadeia de caracteres NULLterminada 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.

Observação Em geral, os dados apontados pelo membro pBlobData da estrutura BLO B 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 contiver 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 as estruturas SERVICE_TYPE_VALUE_ABS que ela contém são predefinidas e, portanto, seus formatos são conhecidos pelo sistema operacional.

Observações

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

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