estrutura SERVICE_TYPE_VALUE_ABSA (nspapi.h)

A estrutura SERVICE_TYPE_VALUE_ABS contém informações sobre um valor de tipo de serviço de rede. Essas informações podem ser específicas para um namespace.

Sintaxe

typedef struct _SERVICE_TYPE_VALUE_ABSA {
  DWORD dwNameSpace;
  DWORD dwValueType;
  DWORD dwValueSize;
  LPSTR lpValueName;
  PVOID lpValue;
} SERVICE_TYPE_VALUE_ABSA, *PSERVICE_TYPE_VALUE_ABSA, *LPSERVICE_TYPE_VALUE_ABSA;

Membros

dwNameSpace

Tipo: DWORD

Um namespace ou um conjunto de namespaces padrão para o qual o valor do tipo de serviço de rede se destina. Os provedores de namespace examinarão apenas os valores destinados ao namespace.

Use uma das seguintes constantes para especificar um namespace:

Valor	Significado
NS_DEFAULT	Um conjunto de namespaces padrão. A função consulta cada namespace dentro desse conjunto. O conjunto de namespaces padrão normalmente inclui todos os namespaces instalados no sistema. No entanto, os administradores do sistema podem excluir namespaces específicos do conjunto. NS_DEFAULT é o valor que a maioria dos aplicativos deve usar para dwNameSpace.
NS_DNS	O Sistema de Nomes de Domínio usado na Internet para resolução de nomes de host.
NS_NETBT	A camada NetBIOS sobre TCP/IP. Todos os sistemas operacionais Windows registram seus nomes de computador com NetBIOS. Esse namespace é usado para converter um nome de computador em um endereço IP que usa esse registro. Observe que NS_NETBT pode acessar um servidor WINS para executar a resolução.
NS_SAP	O Protocolo de Publicidade do Serviço NetWare. Isso pode acessar a associação netware, se apropriado. NS_SAP é um namespace dinâmico que permite o registro de serviços.
NS_TCPIP_HOSTS	Valor de pesquisa no <arquivo systemroot>\system32\drivers\etc\hosts.
NS_TCPIP_LOCAL	Mecanismos locais de resolução de nomes TCP/IP, incluindo comparações com o nome do host local e pesquisa nomes de host e endereços IP no cache de mapeamentos de host para endereço IP.

dwValueType

Tipo: DWORD

O tipo dos dados de valor. Especifique um dos seguintes tipos:

Valor	Significado
REG_BINARY	Dados binários em qualquer formulário.
REG_DWORD	Um número de 32 bits.
REG_MULTI_SZ	Uma matriz de cadeias de caracteres terminada em nulo, terminada por dois caracteres nulos.
REG_SZ	Uma cadeia de caracteres terminada em nulo.

dwValueSize

Tipo: DWORD

O tamanho, em bytes, do valor apontado pelo membro lpValue . No caso de REG_SZ e REG_MULTI_SZ dados de cadeia de caracteres, os caracteres de terminação são contados como parte do tamanho.

lpValueName

Tipo: LPTSTR

Um ponteiro para uma cadeia de caracteres terminada em NULL que é o nome do valor. Esse nome é específico para um namespace.

Várias cadeias de caracteres de nome de valor comumente usadas são associadas a constantes definidas. Essas cadeias de caracteres de nome incluem o seguinte.

Constante	Significado
SERVICE_TYPE_VALUE_SAPID	"SapId"
SERVICE_TYPE_VALUE_CONN	"ConnectionOriented"
SERVICE_TYPE_VALUE_TCPPORT	"TcpPort"
SERVICE_TYPE_VALUE_UDPPORT	"UdpPort"

lpValue

Tipo: PVOID

Um ponteiro para os dados de valor.

Comentários

Quando você usa a função SetService para adicionar um tipo de serviço de rede a um namespace, uma estrutura SERVICE_TYPE_INFO_ABS é passada como membro do BLOB ServiceSpecificInfo de uma estrutura SERVICE_INFO . Embora o membro ServiceSpecificInfo geralmente não deva conter ponteiros, uma exceção é feita no caso das estruturas SERVICE_TYPE_INFO_ABS e SERVICE_TYPE_VALUE_ABS .

Observação

O cabeçalho nspapi.h define SERVICE_TYPE_VALUE_ABS 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

Confira também

SERVICE_INFO

SERVICE_TYPE_INFO_ABS

SetService