Função TLSKeyPackEnumBegin

Inicia a enumeração por meio de todos os pacotes de chaves instalados em um servidor de licença da Área de Trabalho Remota com base nos critérios de pesquisa.

Observação

Essa função não tem nenhum arquivo de cabeçalho associado ou biblioteca de importação. Para chamar essa função, você deve criar um arquivo de cabeçalho definido pelo usuário e usar as funções LoadLibrary e GetProcAddress para vincular dinamicamente a Mstlsapi.dll.

Sintaxe

DWORD WINAPI TLSKeyPackEnumBegin(
  _In_  TLS_HANDLE hHandle,
  _In_  DWORD      dwSearchParm,
  _In_  BOOL       bMatchAll,
  _In_  LSKeyPack  *lpSearchParm,
  _Out_ PDWORD     pdwErrCode
);

Parâmetros

hHandle [in]

Identificador para um servidor de licença da Área de Trabalho Remota. Especifique um identificador aberto pela função TLSConnectToLsServer .

dwSearchParm [in]

Especifica os critérios de pesquisa. Esse parâmetro é reservado para uso futuro e deve conter 0xFFFFFFFF.

bMatchAll [in]

Especifica se todos os valores de pesquisa devem ser correspondidos.

lpSearchParm [in]

Ponteiro para uma estrutura LSKeyPack que especifica os parâmetros de pesquisa a serem procurados.

pdwErrCode [out]

Ponteiro para uma variável que recebe um dos seguintes códigos de erro no retorno.

LSERVER_S_SUCCESS (0)

A chamada foi bem-sucedida.

LSERVER_E_INTERNAL_ERROR (5001)

Erro interno no servidor de licença.

LSERVER_E_INVALID_SEQUENCE (5006)

A sequência de chamada não era válida. Provavelmente, uma enumeração anterior não terminou.

LSERVER_E_SERVER_BUSY (5007)

O servidor de licença está muito ocupado para processar a solicitação.

LSERVER_E_OUTOFMEMORY (5008)

Não é possível processar a solicitação devido à memória insuficiente.

LSERVER_E_INVALID_DATA (5009)

Os dados no parâmetro de pesquisa não são válidos.

Valor retornado

Essa função retorna os seguintes valores de retorno possíveis.

RPC_S_OK

A chamada foi bem-sucedida. Verifique o valor do parâmetro pdwErrCode para obter o código de retorno da chamada.

RPC_S_INVALID_ARG

O argumento não era válido.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
DLL	Mstlsapi.dll

Confira também

LSKeyPack

TLSConnectToLsServer

TLSKeyPackEnumNext

TLSKeyPackEnumEnd