Função TLSKeyPackEnumNext
Continua de uma chamada anterior para a função TLSKeyPackEnumBegin e retorna o próximo pacote de chaves instalado em um servidor de licença da Área de Trabalho Remota que corresponde aos 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 TLSKeyPackEnumNext(
_In_ TLS_HANDLE hHandle,
_In_ LsKeyPack *lpKeyPack,
_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 .
-
lpKeyPack [in]
-
Ponteiro para uma estrutura LSKeyPack que recebe o próximo pacote de chaves que corresponde aos critérios de pesquisa.
-
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_I_NO_MORE_DATA (4001)
-
Não há mais pacotes de chaves que correspondam aos critérios de pesquisa.
-
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. Deve chamar a função TLSKeyPackEnumBegin() antes disso.
-
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.
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 |
|