Uso del moniker coda
Il moniker della coda viene usato per attivare un componente in coda a livello di codice. Il moniker della coda richiede che riceva l'ID classe (CLSID) dell'oggetto da richiamare direttamente dal nuovo moniker a destra di esso. Se preceduto da sinistra, il nuovo moniker passa il CLSID al moniker a sinistra.
Strumento di Amministrazione istrative di Servizi componenti
Non è valida.
Visual Basic
Il parametro del nome visualizzato GetObject è "queue:/new:", seguito dall'ID programma o dal GUID in formato stringa, con o senza parentesi graffe, dell'oggetto server di cui creare un'istanza. Gli esempi seguenti mostrano tre attivazioni valide di un componente con il moniker della coda:
-
Set objMyQC = GetObject ("queue:/new:QCShip.Ship") -
Set objMyQC = GetObject ("queue:/new:{812DF40E-BD88-11D0-8A6D-00C04FC340EE}") -
Set objMyQC = GetObject ("queue:/new:812DF40E-BD88-11D0-8A6D-00C04FC340EE")
C/C++
Il parametro del nome visualizzato CoGetObject è "queue:/new:", seguito dall'ID programma o dal GUID in formato stringa, con o senza parentesi graffe, dell'oggetto server di cui creare un'istanza. Gli esempi seguenti mostrano tre attivazioni valide di un componente con il moniker della coda:
-
hr = CoGetObject ( L"queue:/new:QCShip.Ship", NULL, IID_IShip, (void**)&pShip); -
hr = CoGetObject ( L"queue:/new:{812DF40E-BD88-11D0-8A6D-00C04FC340EE}", NULL, IID_IShip, (void**)&pShip); -
hr = CoGetObject ( L"queue:/new:812DF40E-BD88-11D0-8A6D-00C04FC340EE", NULL, IID_IShip, (void**)&pShip);
Osservazioni:
Il moniker della coda accetta parametri facoltativi che modificano le proprietà del messaggio inviato a Accodamento messaggi. Ad esempio, per fare in modo che il messaggio di accodamento messaggi venga inviato con una priorità 6, il componente in coda verrà attivato come segue:
hr = CoGetObject (
L"queue:Priority=6,ComputerName=MyComp/new:QCShip.Ship",
NULL, IID_IShip, (void**)&pShip);
Nella tabella seguente sono elencati i parametri del moniker della coda che influiscono sulla coda di destinazione.
| Parametro | Descrizione |
|---|---|
| NomeComputer |
Specifica la parte del nome computer di un nome di percorso della coda di accodamento messaggi. Il nome del percorso della coda di accodamento messaggi è formattato come NomeComputer<em>QueueName. Se non specificato, viene usato il nome del computer associato all'applicazione configurata. |
| QueueName |
Specifica il nome della coda di accodamento messaggi. Il nome del percorso della coda di accodamento messaggi è formattato come NomeComputer<em>QueueName. Se non specificato, viene usato il nome della coda associato all'applicazione configurata. Per ottenere una coda non transazionale, è possibile specificare innanzitutto il nome della coda e quindi creare un'applicazione COM+ con lo stesso nome. |
| PathName |
Specifica il nome completo del percorso della coda di accodamento messaggi. Se non specificato, viene usato il nome del percorso della coda di accodamento messaggi associato all'applicazione configurata. Per eseguire l'override del nome di destinazione, è possibile specificare il percorso nel formato seguente per un'installazione del gruppo di lavoro accodamento messaggi: Queue:PathName ComputerName=\PRIVATE$\AppName/new:Myproject.CMyClass Nota: entrambi i linguaggi di programmazione C e Microsoft Visual C++ richiedono due barre rovesciata per rappresentare una barra rovesciata all'interno di valori letterali stringa, ad esempio chicago\payroll. |
| Formatname |
Quando si contrassegna un'applicazione COM+ come in coda, COM+ crea una coda di accodamento messaggi il cui nome corrisponde all'applicazione. Il nome del formato di accodamento messaggi della coda si trova nel catalogo COM+, associato all'applicazione COM+. Per eseguire l'override del nome di destinazione, è possibile specificare il nome del formato nel formato seguente per un'installazione del gruppo di lavoro accodamento messaggi: Queue:FormatName=DIRECT=OS:ComputerName\PRIVATE$\AppName/new:ProgId In una configurazione di Active Directory, "PRIVATE$" non viene specificato come parte del nome della coda. |
Nota
I parametri del moniker della coda facoltativi vengono elaborati da sinistra a destra. Specificare ogni parola chiave una sola volta. Se si specifica il parametro PathName , i parametri ComputerName e QueueNamevengono sostituiti. Un parametro FormatName specifico elimina le conoscenze precedenti di un parametro ComputerName, QueueName e PathName.
Associazione del listener dei componenti in coda a una coda privata specifica
Il listener COM+ Queued Components riceve solo dalle code associate all'applicazione COM+ contrassegnata in coda. Quando si contrassegna un'applicazione COM+ come in coda, COM+ crea una coda di accodamento messaggi il cui nome corrisponde all'applicazione. Il nome del formato di accodamento messaggi della coda si trova nel catalogo COM+, associato all'applicazione COM+. Quando l'applicazione COM+ viene avviata e contrassegnata come listener, viene avviato un listener nel processo dell'applicazione COM+ e la coda viene aperta. Nella tabella seguente sono elencati i parametri del moniker della coda che influiscono sul messaggio di accodamento messaggi.
| Parametro | Descrizione |
|---|---|
| AppSpecific |
Specifica un intero senza segno, ad esempio AppSpecific=12345. |
| AuthLevel |
Specifica il livello di autenticazione del messaggio. Un messaggio autenticato è firmato digitalmente e richiede un certificato per l'utente che invia il messaggio. Valori accettabili:
|
| Recapito |
Specifica l'opzione di recapito dei messaggi. Questo valore viene ignorato per le code transazionali. Valori accettabili:
|
| EncryptAlgorithm |
Specifica l'algoritmo di crittografia da utilizzare da Accodamento messaggi per crittografare e decrittografare il messaggio. Valori accettabili:
|
| Hashalgorithm |
Specifica una funzione hash crittografica. Valori accettabili:
|
| Giornale di registrazione |
Specifica l'opzione Message Queuing Message Journal . Valori accettabili:
|
| Etichetta |
Specifica una stringa di etichetta del messaggio fino a MQ_MAX_MSG_LABEL_LEN caratteri. |
| MaxTimeToReachQueue |
Specifica un tempo massimo, espresso in secondi, affinché il messaggio raggiunga la coda. Valori accettabili:
|
| MaxTimeToReceive |
Specifica un tempo massimo, espresso in secondi, per la ricezione del messaggio dall'applicazione di destinazione. Valori accettabili:
|
| Priorità |
Specifica un livello di priorità del messaggio, all'interno dei valori di Accodamento messaggi consentiti. Valori accettabili:
|
| PrivLevel |
Specifica un livello di privacy, usato per crittografare i messaggi. Valori accettabili:
|
| Traccia |
Specifica le opzioni di traccia utilizzate per tracciare il routing di Accodamento messaggi. Valori accettabili:
|
Il set completo di funzioni COM+ Amministrazione istrative SDK è disponibile tramite oggetti COM. Ciò consente a qualsiasi programma di avviare e arrestare le applicazioni COM+ in base alle esigenze.
Nota
Quando viene avviata un'applicazione COM+, si tratta dell'applicazione in esecuzione, non dei singoli componenti all'interno dell'applicazione. Se un'applicazione chiama un componente non in coda, viene avviata l'applicazione COM+ che contiene il componente. Se la casella di controllo del listener è abilitata, il listener avvia e avvia anche l'elaborazione dei messaggi per i componenti in coda. Anche se il servizio componenti in coda può essere avviato in questo modo, se si inseriscono componenti in coda e non in coda in una singola applicazione COM+, assicurarsi di voler avviare i componenti in coda se viene eseguito un componente non in coda. In caso contrario, creare un pacchetto dei componenti in coda in un'applicazione COM+ separata dagli altri componenti.