Metodo IStillImageW::RegisterLaunchApplication (sti.h)

Il metodo IStillImage::RegisterLaunchApplication aggiunge un'applicazione all'elenco di monitor eventi di immagini ancora presenti in applicazioni con riconoscimento del modello push.

Sintassi

HRESULT RegisterLaunchApplication(
  [in] LPWSTR pwszAppName,
  [in] LPWSTR pwszCommandLine
);

Parametri

[in] pwszAppName

Puntatore fornito dal chiamante a una stringa che rappresenta il "nome breve" dell'applicazione, che verranno visualizzati scanner e fotocamere Pannello di controllo finestra delle proprietà.

[in] pwszCommandLine

Puntatore fornito dal chiamante a una stringa che rappresenta la riga di comando necessaria per avviare l'applicazione, incluso il percorso completo del file eseguibile dell'applicazione. Il percorso corrente può essere ottenuto chiamando GetModuleFileName (descritto nella documentazione di Microsoft Windows SDK). Per altre informazioni, vedere la sezione Osservazioni seguente.

Valore restituito

Se l'operazione ha esito positivo, il metodo restituisce S_OK. In caso contrario, restituisce uno dei codici di errore con prefisso STIERR definiti in stierr.h.

Commenti

Un'applicazione (o il programma di installazione dell'applicazione) deve chiamare IStillImage::RegisterLaunchApplication in modo che il monitoraggio eventi immagine ancora sappia della sua esistenza. Gli utenti associano Still Image Device Events alle applicazioni registrate usando l'interfaccia della finestra delle proprietà di Pannello di controllo. Dopo che un utente ha associato un evento del dispositivo all'applicazione, il monitoraggio eventi avvierà l'applicazione quando si verifica l'evento.

Il metodo scrive il percorso di caricamento dell'applicazione nel Registro di sistema. Pertanto, il metodo deve essere chiamato ogni volta che viene eseguita l'applicazione, perché l'utente potrebbe aver spostato il file e GetModuleFileName restituisce sempre il percorso del file corrente.

È possibile includere gli argomenti di comando nella riga di comando dell'applicazione. Quando si avvia un'applicazione registrata, il monitoraggio eventi aggiunge i due argomenti seguenti alla riga di comando:

Argomento della riga di comando	Descrizione
**/StiDevice:**InternalDeviceName	InternalDeviceName è il nome interno del dispositivo per il quale viene avviata l'applicazione.
**/StiEvent:**EventGUID	EventGUID è la rappresentazione di stringa del GUID per l'evento del dispositivo che si è verificato.

L'applicazione può ottenere i valori specificati per questi argomenti chiamando IStillImage::GetSTILaunchInformation.

Prima di chiamare IStillImage::RegisterLaunchApplication, i client dell'interfaccia COM IStillImage devono chiamare IStillImage::StiCreateInstance per ottenere un puntatore all'interfaccia IStillImage .

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	sti.h (include Sti.h)