IDkmSymbolDocumentCollectionQuery.FindDocuments(DkmModule, DkmSourceFileId) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает объекты документа из параметров поиска, содержащихся в запросе документа. Если файл символов не содержит ссылку на этот документ, возвращаемый объект документа будет иметь значение NULL (S_FALSE код возврата в машинном коде). Возвращаемые объекты документа должны быть явным образом закрыты вызывающим объектом, когда вызывающий объект завершает работу с документом.
public:
cli::array <Microsoft::VisualStudio::Debugger::Symbols::DkmResolvedDocument ^> ^ FindDocuments(Microsoft::VisualStudio::Debugger::Symbols::DkmModule ^ module, Microsoft::VisualStudio::Debugger::Symbols::DkmSourceFileId ^ sourceFileId);
public Microsoft.VisualStudio.Debugger.Symbols.DkmResolvedDocument[] FindDocuments (Microsoft.VisualStudio.Debugger.Symbols.DkmModule module, Microsoft.VisualStudio.Debugger.Symbols.DkmSourceFileId sourceFileId);
abstract member FindDocuments : Microsoft.VisualStudio.Debugger.Symbols.DkmModule * Microsoft.VisualStudio.Debugger.Symbols.DkmSourceFileId -> Microsoft.VisualStudio.Debugger.Symbols.DkmResolvedDocument[]
Public Function FindDocuments (module As DkmModule, sourceFileId As DkmSourceFileId) As DkmResolvedDocument()
Параметры
- module
- DkmModule
Окне Класс Дкммодуле представляет набор кода (например, DLL или exe), который или один раз был загружен в один или несколько процессов. Класс Дкммодуле является центральным объектом для API символов и имеет 1:1 с нотацией обработчика символов, что загружается. Если набор кода загружается в три разных процесса (или один процесс, но с тремя разными базовыми адресами или с тремя разными доменами приложений), но обработчик символов считает все эти данные идентичными, будет существовать только один объект Module.
- sourceFileId
- DkmSourceFileId
Окне Определяет исходный файл и предоставляет сведения, которые обработчик символов может использовать для поиска сведений об этом исходном файле в файле символов (PDB).
Возвращаемое значение
Заполняет Коллекция документов, соответствующих запросу.