Begrijpen van uitgebreide foutinformatie

Uitgebreide foutinformatie is een matrix met records, die elk het doorgeven van de foutcode via een bepaalde laag in het systeem of de toepassing aangeven. Als er een fout optreedt op een computer C, zoals deze wordt aangeroepen vanaf machine B, die op zijn beurt wordt aangeroepen vanaf machine A, genereert de RPC-uitvoeringstijd op machine C een of meer records die de fout beschrijven en geeft deze door aan machine B. Machine B kan een of meer records toevoegen aan het hoofd van de bestaande keten, en geeft de volledige keten door aan A. Een kan een of meer records toevoegen en de informatie weergeven of vastleggen. In wezen vertegenwoordigt de uitgebreide foutketen de geschiedenis van de fout.

Uitgebreide foutinformatie vervangt de foutcode (de RPC_S_*-statuscode) niet. Ongeacht hoeveel of uitgebreide foutgegevens worden gegenereerd, blijft de foutcode ongewijzigd.

Elke uitgebreide foutinformatierecord bevat het volgende. Zie RPC_EXTENDED_ERROR_INFO voor meer informatie:

• ComputerName: dit is de niet-gekwalificeerde DNS-naam van de computer waarop de fout is ontstaan. Alleen records op computergrenzen hebben deze informatie. In het scenario dat eerder is beschreven met computers A, B en C, wordt computernaam bijvoorbeeld gedefinieerd voor de volgende velden:

  Record	Veld Computernaam
  Record #1 gegenereerd door machine C	-
  Record #2 gegenereerd door machine C	-
  Record #3 gegenereerd door machine C	C
  Record #1 gegenereerd door machine B	-
  Record #2 gegenereerd door machine B	-
  Record #3 gegenereerd door machine B	B
  Record #1 gegenereerd door machine A	-
  Record #2 gegenereerd door machine A	-
  Record #3 gegenereerd door machine A	-
  Hoofd van de keten

   

• ProcessID: proces-id van het proces dat de fout heeft gegenereerd.

• TimeStamp: tijd waarop de fout is opgetreden, uitgedrukt in UTC-indeling.

• Component genereren: definitie van gehele code van het logische onderdeel dat de fout heeft gegenereerd. De volgende onderdelen zijn momenteel gedefinieerd:

  Code	Naam	Beschrijving
  1	Applicatie	Het onderdeel dat eigenaar is van de managerroutine voor de specifieke RPC-aanroep
  2	Looptijd	De RPC-runtime
  3	Beveiligingsprovider	De beveiligingsprovider voor deze aanroep.
  4	NPFS	Het NPFS-bestandssysteem
  5	RDR	De Doorverwijzer
  6	NMP	Het benoemde pijpsysteem. Dit kan NPFS of RDR zijn, maar in veel gevallen weet de RPC-uitvoeringstijd niet wie de aangevraagde bewerking heeft uitgevoerd en in dergelijke gevallen wordt NMP geretourneerd.
  7	IO	Het IO-systeem of een stuurprogramma dat door het IO-systeem wordt gebruikt. Dit kan NPFS, RDR of een Winsock-provider zijn.
  8	Winsock	De Winsock-provider
  9	Authz-code	De autorisatie-API's.
  10	LPC	De faciliteit voor lokale procedureoproepen.

   

• Status: foutcode gegenereerd of geretourneerd door de laag
• DetectionLocation: uniek nummer waarmee de locatie van de code wordt geïdentificeerd waar de fout is gedetecteerd. Dit veld is gekoppeld aan de code en wordt gewijzigd van versie in versie. Er wordt een afzonderlijke lijst met de meest voorkomende detectielocaties gepubliceerd.
• Vlaggen: vlaggen die informatie over de record opgeven. De momenteel gedefinieerde vlaggen zijn respectievelijk EEInfoPreviousRecordsMissing en EEInfoNextRecordsMissing, die overeenkomen met respectievelijk numerieke waarden 1 en 2. Als EEInfoPreviousRecordsMissing is ingesteld, ontbreekt één of meer records vóór dat record. Als EEInfoNextRecordsMissing is ingesteld, ontbreken een of meer records na die record. Zie betrouwbaarheid van uitgebreide foutinformatievoor een beschrijving van waarom records mogelijk ontbreken.
• Maximaal vier foutparameters. Een foutparameter is een lichtgewicht variantstructuur die aanvullende informatie over de fout biedt. De aanvullende informatie is afhankelijk van de fout en de detectielocatie. De parameters kunnen van het type ANSI-tekenreeks (LPSTR), Unicode-tekenreeks (LPWSTR), lange waarde (lang), korte waarde (kort), aanwijzer (int64) of geen zijn.