Função SHCreateProcessAsUserW (shellapi.h)

[SHCreateProcessAsUserW não é implementado em sistemas Windows XP ou posteriores.]

Cria um novo processo de modo de usuário e seu thread primário para executar um arquivo executável especificado.

Sintaxe

BOOL SHCreateProcessAsUserW(
  [in, out] PSHCREATEPROCESSINFOW pscpi
);

Parâmetros

[in, out] pscpi

Tipo: PSHCREATEPROCESSINFOW

Um ponteiro para uma estrutura SHCREATEPROCESSINFOW com informações sobre como criar o processo.

Retornar valor

Tipo: BOOL

Retornará TRUE se tiver êxito ou FALSE se não for. Para recuperar informações de erro estendidas, chame GetLastError.

Comentários

Essa função é semelhante a ShellExecuteEx com runas como o verbo. No entanto, SHCreateProcessAsUserW cria um processo que é executado no contexto de segurança do usuário representado pelo membro hUserToken da estrutura apontada pelo pscpi. O membro lpProcessInformation pode ser usado para retornar uma estrutura PROCESS_INFORMATION com informações sobre o novo processo.

O verbo runas deve ter suporte pelo tipo de arquivo do arquivo executável. O tipo de arquivo .exe dá suporte a runas. Use a função AssocQueryString para marcar se o runas tem suporte de outros tipos de arquivo. O fragmento de código a seguir ilustra a sintaxe.

AssocQueryString(0, ASSOCSTR_COMMAND, pszFile, TEXT("runas"), NULL, &cchVerb)

Para obter uma discussão sobre como usar o Shell para iniciar aplicativos, consulte Iniciando aplicativos.

Não há suporte para SHCreateProcessAsUserW no Windows XP. Os usuários que exigem funcionalidade semelhante devem examinar CreateProcess, CreateProcessAsUser, CreateProcessWithLogonW e ShellExecuteEx, avaliando cuidadosamente cada um com base na funcionalidade e segurança necessárias. IQueryAssociations pode ser usado para extrair informações usadas com CreateProcess, se necessário.

Requisitos

Confira também

CreateProcess

Createprocessasuser

CreateProcessWithLogonW

Shellexecuteex