Compartir a través de

GETOBJECT( ) (Función)

  • Artículo

Activa un objeto de Automatización y crea una referencia al mismo.

GETOBJECT(cFileName | Moniker [, cClassName])

Devuelve

Una referencia al objeto.

Parámetros

  • cFileName
    Especifica la ruta de acceso completa y el nombre del archivo que se va a activar. No es necesario especificar la aplicación, porque las bibliotecas de vínculos dinámicos OLE determinan la aplicación que se va a iniciar basándose en el nombre de archivo que usted les proporciona.

    Por ejemplo, el código siguiente lanza Microsoft Excel, abre un archivo llamado BUDGET.XLS, y crea una referencia a través de una variable de objeto llamada MBUDVAR:

    MBUDVAR = GETOBJECT('C:\EXCEL\WORK\BUDGET.XLS')

  • Moniker
    El identificador de un objeto COM que implementa la interfaz IMoniker. Un moniker puede ser de uno de los tipos siguientes: archivo, elemento, compuesto genérico, anti-, puntero y dirección URL. Para ver detalles acerca de los monikers COM, busque "IMoniker" en Microsoft Developer Network.

  • cClassName
    Especifica el nombre de clase del objeto que se va a recuperar. Algunas aplicaciones pueden almacenar más de un tipo de objeto en el mismo archivo, lo que permite utilizar el nombre de clase para especificar el objeto que se va a activar. Por ejemplo, si una aplicación de procesamiento de textos almacena sus documentos, definiciones de macro y objetos de barra de herramientas en el mismo archivo, puede crear una referencia al archivo de documento con el comando siguiente:

    MDOCFILE = GETOBJECT('C:\WRDPROC\MYDOC.DOC','WrdProc.Document')

    Con algunas aplicaciones servidoras, cada vez que ejecuta GETOBJECT( ), se inicia una instancia adicional de la aplicación, usando memoria adicional. Si la aplicación ya está en ejecución, puede impedir que se inicien otras instancias de la aplicación si omite FileName e incluye ClassName, como en este ejemplo:

    oleApp = GETOBJECT(, "Excel.Application")

Observaciones

Utilice GETOBJECT( ) para activar un objeto de Automatización a partir de un archivo y asignar una referencia al objeto a través de una variable de memoria o un elemento de matriz.

Si especifica un nombre de archivo o de clase no válido, se mostrará un error de OLE, y la función GETOBJECT( ) devolverá una cadena vacía.

Ejemplo

Por ejemplo, en una red que tenga implementados los servicios de Active Directory, puede consultar la red para obtener información acerca de un usuario concreto.

   *  Replace "DomainName" with the domain name, and "UserLoginID"
   *  with the login ID of the user you are looking up.
   oUser = GetObject("WinNT://DomainName/UserLoginID,user")
   ? oUser.FullName

Vea también

COMCLASSINFO( ) | CREATEOBJECT( ) | DEFINE CLASS | SET OLEOBJECT | GETINTERFACE( )