Compartilhar via


Método IShellDispatch2.GetSystemInformation

Recupera informações do sistema.

Sintaxe

retVal = IShellDispatch2.GetSystemInformation(
  sName
)

IShellDispatch2.GetSystemInformation( _
  ByVal sName As BSTR _
) As Variant

Parâmetros

sName [in]

Tipo: BSTR

Uma Cadeia de Caracteres que especifica as informações do sistema que estão sendo solicitadas.

Valor retornado

JScript

Tipo: Variant

Retorna o valor das informações do sistema solicitadas. O tipo de retorno depende de quais informações do sistema são solicitadas. Consulte a seção Comentários para obter detalhes.

VB

Tipo: Variant

Retorna o valor das informações do sistema solicitadas. O tipo de retorno depende de quais informações do sistema são solicitadas. Consulte a seção Comentários para obter detalhes.

Comentários

Esse método é implementado e acessado por meio do método Shell.GetSystemInformation .

Esse método pode ser usado para solicitar muitos valores de informações do sistema. A tabela a seguir fornece o valor sName usado para solicitar as informações e o tipo associado do valor retornado.

sName

Tipo de retorno

Descrição

DirectoryServiceAvailable

Booliano

Defina como true se o serviço de diretório estiver disponível; caso contrário, false.

Doubleclicktime

Inteiro

O tempo de clique duplo, em milissegundos.

ProcessorLevel

Inteiro

Windows Vista e posteriores. O nível do processador. Retorna 3, 4 ou 5, para processadores no nível x386, x486 e Pentium, respectivamente.

ProcessorSpeed

Inteiro

A velocidade do processador, em megahertz (MHz).

ProcessorArchitecture

Inteiro

A arquitetura do processador. Para obter detalhes, consulte a discussão do membro wProcessorArchitecture da estrutura SYSTEM_INFO .

PhysicalMemoryInstalled

Inteiro

A quantidade de memória física instalada, em bytes.

As opções a seguir são válidas somente no Windows XP.

IsOS_Professional

Booliano

Defina como true se o sistema operacional for Windows XP Professional Edition; caso contrário, false.

IsOS_Personal

Booliano

Defina como true se o sistema operacional for Windows XP Home Edition; caso contrário, false.

A seguir, é válido somente no Windows XP e posterior.

IsOS_DomainMember

Booliano

Defina como true se o computador for membro de um domínio; caso contrário, false.

 

Esse método não está disponível no momento no Microsoft Visual Basic.

Exemplos

Os exemplos a seguir mostram o uso de GetSystemInformation para JScript e VBScript.

Jscript:

<script language="JavaScript">
    function fnGetSystemInformationJ()
    {
        var objShell = new ActiveXObject("shell.application");
        var vReturn;

        vReturn = objShell.GetSystemInformation("ProcessorLevel");
        document.write(vReturn);
    }
</script>

Vbscript:

<script language="VBScript">
    function fnGetSystemInformationVB()
        dim objShell
        dim vReturn

        set objShell = CreateObject("shell.application")

        vReturn = objShell.GetSystemInformation("ProcessorLevel")
        document.write(vReturn)

        set objShell = nothing
    end function
</script>

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho
Shldisp.h
IDL
Shldisp.idl
DLL
Shell32.dll (versão 5.0 ou posterior)