Eventi
19 nov, 23 - 21 nov, 23
Ottenere il vantaggio competitivo necessario con potenti soluzioni di intelligenza artificiale e cloud partecipando a Microsoft Ignite online.
Iscriviti subitoQuesto browser non è più supportato.
Esegui l'aggiornamento a Microsoft Edge per sfruttare i vantaggi di funzionalità più recenti, aggiornamenti della sicurezza e supporto tecnico.
Analizza il nome visualizzato specificato e crea un moniker corrispondente.
HRESULT ParseDisplayName(
[in] IBindCtx *pbc,
[in] LPOLESTR pszDisplayName,
[out] ULONG *pchEaten,
[out] IMoniker **ppmkOut
);
[in] pbc
Puntatore al contesto di associazione da usare in questa operazione di associazione. Vedere IBindCtx.
[in] pszDisplayName
Nome visualizzato da analizzare.
[out] pchEaten
Puntatore a una variabile che riceve il numero di caratteri nel nome visualizzato corrispondente al moniker ppmkOut .
[out] ppmkOut
Puntatore a una variabile puntatore IMoniker che riceve il puntatore dell'interfaccia al moniker risultante. Se si verifica un errore, l'implementazione imposta *ppmkOut su NULL. Se *ppmkOut non è NULL, l'implementazione deve chiamare AddRef; è responsabilità del chiamante chiamare Release.
Questo metodo può restituire i valori restituiti standard E_OUTOFMEMORY e E_UNEXPECTED, nonché i valori seguenti.
Codice restituito | Descrizione |
---|---|
|
Metodo completato correttamente. |
|
Si verifica un errore di sintassi nel nome visualizzato. L'analisi non è riuscita perché pszDisplayName potrebbe essere risolto parzialmente in un moniker. In questo caso* pchEaten ha il numero di caratteri che sono stati analizzati correttamente in un prefisso moniker. Il parametro ppmkOut deve essere NULL. |
|
Il nome visualizzato non identifica un componente nello spazio dei nomi. |
|
Uno o più parametri non sono validi. |
In generale, il prefisso massimo di pszDisplayName che è sintatticamente valido e che rappresenta un oggetto deve essere utilizzato da questo metodo e convertito in un moniker.
In genere, questo metodo viene chiamato da MkParseDisplayName o MkParseDisplayNameEx. Nel passaggio iniziale dell'operazione di analisi, queste funzioni possono recuperare l'interfaccia IParseDisplayName direttamente da un'istanza di una classe identificata con la notazione "@ProgID" o "ProgID". I passaggi di analisi successivi possono eseguire query sull'interfaccia in un oggetto intermedio.
I cicli principali di MkParseDisplayName e MkParseDisplayNameEx trovano il successivo moniker chiamando il metodo equivalente nell'interfaccia IMoniker, ovvero IMoniker::P arseDisplayName, nel moniker che attualmente contiene. In questa chiamata a IMoniker::P arseDisplayName, la funzione MkParseDisplayName o MkParseDisplayNameEx passa NULL nel parametro pmkToLeft. Se il moniker attualmente tenuto è un composito generico, la chiamata a IMoniker::P arseDisplayName viene inoltrata da tale composito nell'ultimo pezzo, passando il prefisso del composito a sinistra del pezzo in pmkToLeft.
Alcune classi moniker potranno gestire questa analisi internamente a se stessi perché sono progettate per designare solo determinati tipi di oggetti. Altri dovranno associare all'oggetto che designano per eseguire il processo di analisi. Come in genere, questi oggetti non devono essere rilasciati da IMoniker::P arseDisplayName, ma devono essere trasferiti al contesto di associazione tramite IBindCtx::RegisterObjectBound o IBindCtx::GetRunningObjectTable seguito da IRunningObjectTable::Register per la versione in un secondo momento.
Requisito | Valore |
---|---|
Client minimo supportato | Windows 2000 Professional [solo app desktop] |
Server minimo supportato | Windows 2000 Server [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | oleidl.h |
Eventi
19 nov, 23 - 21 nov, 23
Ottenere il vantaggio competitivo necessario con potenti soluzioni di intelligenza artificiale e cloud partecipando a Microsoft Ignite online.
Iscriviti subito