Estrutura SHCREATEPROCESSINFOW (shellapi.h)
[SHCreateProcessAsUserW não é mais implementado no Windows XP ou em versões posteriores.]
Contém as informações necessárias SHCreateProcessAsUserW para criar um processo.
Sintaxe
typedef struct _SHCREATEPROCESSINFOW {
DWORD cbSize;
ULONG fMask;
HWND hwnd;
LPCWSTR pszFile;
LPCWSTR pszParameters;
LPCWSTR pszCurrentDirectory;
HANDLE hUserToken;
LPSECURITY_ATTRIBUTES lpProcessAttributes;
LPSECURITY_ATTRIBUTES lpThreadAttributes;
BOOL bInheritHandles;
DWORD dwCreationFlags;
LPSTARTUPINFOW lpStartupInfo;
LPPROCESS_INFORMATION lpProcessInformation;
} SHCREATEPROCESSINFOW, *PSHCREATEPROCESSINFOW;
Membros
cbSize
Tipo: DWORD
O tamanho, em bytes, dessa estrutura.
fMask
Tipo: ULONG
Uma matriz de sinalizadores que indica o conteúdo e a validade dos outros membros da estrutura. Isso pode ser uma combinação dos valores a seguir.
SEE_MASK_CLASSKEY
Use a chave do registro de classe do arquivo.
SEE_MASK_CLASSNAME
Use o nome da classe do arquivo.
SEE_MASK_CONNECTNETDRV
Valide o compartilhamento e conecte-se a uma letra da unidade. O membro pszFile é um caminho UNC de um arquivo em uma rede.
SEE_MASK_DOENVSUBST
Expanda todas as variáveis de ambiente.
SEE_MASK_FLAG_DDEWAIT
Aguarde até que a conversa do DDE seja encerrada antes de retornar.
SEE_MASK_FLAG_NO_UI
Não exiba uma caixa de mensagem de erro se ocorrer um erro.
SEE_MASK_HMONITOR
Use esse sinalizador ao especificar um monitor em sistemas multimonitor.
SEE_MASK_NOCLOSEPROCESS
O aplicativo fechará o processo. Se o membro lpProcessInformation for um ponteiro de PROCESS_INFORMATION válido e SEE_MASK_NOCLOSEPROCESS for definido, o processo permanecerá aberto quando SHCreateProcessAsUserW retornar. Os membros hProcess e hThread membros da estrutura PROCESS_INFORMATION mantêm o processo e os identificadores de thread, respectivamente. Esse sinalizador normalmente é definido para permitir que um aplicativo descubra quando um processo criado com SHCreateProcessAsUserW termina. Em alguns casos, como quando a execução é atendida por meio de uma conversa de DDE, nenhum identificador será retornado. O aplicativo de chamada é responsável por fechar o identificador quando ele não é mais necessário. Se esse sinalizador não estiver definido, o processo será fechado antes que SHCreateProcessAsUserW retorne, mesmo que lpProcessInformation seja um ponteiro válido.
SEE_MASK_NO_CONSOLE
Crie um console para o novo processo em vez de tê-lo herdado do console pai. É equivalente a usar um sinalizador de CREATE_NEW_CONSOLE com CreateProcess.
SEE_MASK_UNICODE
Indica um aplicativo Unicode.
hwnd
Tipo: HWND
Um identificador de janela pai.
pszFile
Tipo: LPCWSTR
Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o arquivo executável no qual SHCreateProcessAsUserW executará a ação especificada pelo runas verbo. O executado como verbo deve ter suporte da classe do arquivo.
pszParameters
Tipo: LPCWSTR
Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém os parâmetros do aplicativo. Os parâmetros devem ser separados por espaços.
pszCurrentDirectory
Tipo: LPCWSTR
Uma cadeia de caracteres Unicode terminada em nulo que contém o diretório atual.
hUserToken
Tipo: HANDLE
Um token Access que pode ser usado para representar um usuário específico. É necessário quando há vários usuários para essas pastas que são tratadas como pertencentes a um único usuário. O aplicativo de chamada deve ter privilégios de segurança apropriados para o usuário específico, incluindo TOKEN_QUERY e TOKEN_IMPERSONATE, e o hive do registro do usuário deve estar montado no momento. Para obter mais discussões sobre problemas de controle de acesso, consulte controle de acesso.
lpProcessAttributes
Tipo: LPSECURITY_ATTRIBUTES
Um ponteiro para uma estrutura de SECURITY_ATTRIBUTES com o descritor de segurança para o novo processo. Ele também especifica se um processo filho pode ser herdado. Se esse parâmetro for definido como NULL, o processo terá um descritor de segurança padrão e o identificador não poderá ser herdado.
Aviso de Segurança: Usar um descritor de segurança incorretamente pode comprometer a segurança do aplicativo. Para obter mais informações, consulte SECURITY_ATTRIBUTES.
lpThreadAttributes
Tipo: LPSECURITY_ATTRIBUTES
Um ponteiro para uma estrutura SECURITY_ATTRIBUTES com o descritor de segurança para o novo thread. Ele também especifica se um processo filho pode ser herdado. Se esse parâmetro for definido como NULL, o processo terá um descritor de segurança padrão e o identificador não poderá ser herdado.
Aviso de Segurança: Usar um descritor de segurança incorretamente pode comprometer a segurança do aplicativo. Para obter mais informações, consulte SECURITY_ATTRIBUTES.
bInheritHandles
Tipo: BOOL
Um indicador para saber se o novo processo herda identificadores do processo de chamada. Se definido como VERDADEIRO, cada identificador aberto herdável no processo de chamada será herdado pelo novo processo. Os identificadores herdados têm o mesmo valor e privilégios de acesso que os identificadores originais.
dwCreationFlags
Tipo: DWORD
Sinalizadores que controlam a criação do processo e a classe de prioridade. Para obter uma lista dos sinalizadores disponíveis, consulte CreateProcessAsUser.
lpStartupInfo
Tipo: LPSTARTUPINFOW
Um ponteiro para uma estrutura STARTUPINFO
lpProcessInformation
Tipo: LPPROCESS_INFORMATION
Um ponteiro para uma estrutura de PROCESS_INFORMATION que recebe informações sobre o novo processo. Defina esse membro como um ponteiro de estrutura válido e defina o sinalizador SEE_MASK_NOCLOSEPROCESS no membro fMask e o processo permanecerá aberto quando a função retornar. Os membros
Observações
Para incluir aspas duplas em pszParameters, você deve colocar cada marca em um par de aspas, como no exemplo a seguir:
sei.lpParameters = "An example: \"\"\"quoted text\"\"\"";
Nesse caso, o aplicativo recebe três parâmetros: Um, exemplo:, e "texto entre aspas".
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows Server 2003 [somente aplicativos da área de trabalho] |
| cabeçalho | shellapi.h |