IDBPromptInitialize Interface

IID_IDBPromptInitialize

{2206CCB0-19C1-11D1-89E0-00C04FD7A829}

The IDBPromptInitialize interface allows the display of the data link dialog boxes programmatically. Using the data link user interface, users can build a connection string dynamically or select an existing data link (.udl) file.

Documentation: IDBPromptInitialize

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IDBPromptInitialize Methods

Description

PromptDataSource

Given a connection string, instantiates and returns a data source object.

PromptFileName

Given a data source object, returns a connection string.

PromptDataSource

DECLARE FUNCTION Proto_IDBPromptInitialize_PromptDataSource ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL pUnkOuter AS DWORD _

, BYVAL hwndParent AS DWORD _

, BYVAL dwPromptOptions AS DWORD _

, BYVAL cSourceTypeFilter AS DWORD _

, BYVAL rgSourceTypeFilter AS DWORD _

, BYVAL pwszszzProviderFilter AS DWORD _

, BYREF riid AS GUID _

, BYREF ppDataSource AS DWORD _

  ) AS LONG

FUNCTION IDBPromptInitialize_PromptDataSource ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL pUnkOuter AS DWORD _

, BYVAL hwndParent AS DWORD _

, BYVAL dwPromptOptions AS DWORD _

, BYVAL cSourceTypeFilter AS DWORD _

, BYVAL rgSourceTypeFilter AS DWORD _

, BYVAL strProviderFilter AS STRING _

, BYREF riid AS GUID _

, BYREF ppDataSource AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  LOCAL pwszszzProviderFilter AS DWORD
  IF LEN(strProviderFilter) THEN
     strProviderFilter = UCODE$(strProviderFilter) & $NUL & $NUL
     pwszszzProviderFilter = STRPTR(strProviderFilter)
  END IF
  CALL DWORD @@pthis[3] USING Proto_IDBPromptInitialize_PromptDataSource (pthis, pUnkOuter, hwndParent, dwPromptOptions, cSourceTypeFilter, rgSourceTypeFilter, pwszszzProviderFilter, riid, ppDataSource) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

PromptFileName

DECLARE FUNCTION Proto_IDBPromptInitialize_PromptFileName ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL hwndParent AS DWORD _

, BYVAL dwPromptOptions AS DWORD _

, BYVAL pwszInitialDirectory AS DWORD _

, BYVAL pwszInitialFile AS DWORD _

, BYREF ppwszSelectedFile AS DWORD _

  ) AS LONG

FUNCTION IDBPromptInitialize_PromptFileName ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL hwndParent AS DWORD _

, BYVAL dwPromptOptions AS DWORD _

, BYVAL strInitialDirectory AS STRING _

, BYVAL strInitialFile AS STRING _

, BYREF ppwszSelectedFile AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  LOCAL pwszInitialDirectory AS DWORD
  IF LEN(strInitialDirectory) THEN
     strInitialDirectory = UCODE$(strInitialDirectory) & $NUL
     pwszInitialDirectory = STRPTR(strInitialDirectory)
  END IF
  strInitialFile = UCODE$(strInitialFile) & $NUL
  CALL DWORD @@pthis[3] USING Proto_IDBPromptInitialize_PromptFileName (pthis, hwndParent, dwPromptOptions, pwszInitialDirectory, STRPTR(strInitialFile), ppwszSelectedFile) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION