GETOBJECT( ) (Función)
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( )